KanziRuntime Class Reference

Kanzi runtime infrastructure for an Android application. More...

Classes
class	Reference
	Manages the lifetime of the KanziRuntime in one process. More...

Public Member Functions
void	executeNativeGarbageCollection ()
	Executes the native garbage collection manually. More...
Domain	getDomain ()
	Returns the Kanzi UI domain that was created for this runtime. More...
long	getNative ()
	Gets a pointer to the backing C++ instance. More...
void	loadKzb (String fileName) throws FileNotFoundException
	Loads a kzb file from the file system, if the file is not already loaded. More...
void	scheduleNativeGarbageCollection (long delayInMs)
	Schedules automatic garbage collection of native objects to occur on given interval. More...
void	setResourceDirectory (String path)
	Sets the source directory for kzb file reading and relative file reading performed through file resource protocol. More...
void	stopNativeGarbageCollection ()
	Cancels automatic garbage collection of native objects started by scheduleNativeGarbageCollection(long delayInMs).

Static Public Member Functions
static Reference	acquire (Context context)
	Acquire a Reference to the KanziRuntime. More...

Detailed Description

Kanzi runtime infrastructure for an Android application.

Member Function Documentation

static Reference acquire ( Context  context )

static

Acquire a Reference to the KanziRuntime.

If KanziRuntime is not already initialized, you initialize it when you call this function.

Parameters

context

The Android context used by the Kanzi Runtime. Can be an Activity or an Application Context.

Returns

The Reference that owns Kanzi Runtime.

void executeNativeGarbageCollection

(

)

Executes the native garbage collection manually.

This operation can be set to be performed periodically by calling scheduleNativeGarbageCollection(long delayInMs).

Domain getDomain

(

)

Returns the Kanzi UI domain that was created for this runtime.

Returns

Domain for this runtime.

long getNative

(

)

Gets a pointer to the backing C++ instance.

Returns

A pointer to the backing C++ instance. Type: kanzi::Application*.

void loadKzb

(

String

fileName

)

throws FileNotFoundException

Loads a kzb file from the file system, if the file is not already loaded.

You can also pass a cfg file that contains a list of kzb files that you want to load.

To load additional kzb files with the same name, use ResourceManager#addKzbFile(String).

Parameters

fileName

The name of the kzb file to load.

Exceptions

InvalidKzbFileException	Throws an InvalidKzbFileException when the kzb file is invalid.
FileNotFoundException	Throws a FileNotFoundException when the kzb file is not found.

void scheduleNativeGarbageCollection

(

long

delayInMs

)

Schedules automatic garbage collection of native objects to occur on given interval.

In case the automatic garbage collection is not desired, it must be called manually.

Parameters

delayInMs

Interval for garbage collection, in milliseconds.

void setResourceDirectory

(

String

path

)

Sets the source directory for kzb file reading and relative file reading performed through file resource protocol.

When set to empty string, APK assets directory is used as the source directory. This is the default value.

Parameters

path	The path to use.